home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / town10.arc / TOWN.DOC < prev    next >
Text File  |  1991-03-16  |  11KB  |  255 lines
  1.  
  2.        ╒══════════════════════════════════════════════════════════════╕
  3.        │                             THE                              │
  4.        │                                                              │▒▒
  5.        │        ████████   ███████   ██       ██   ████  ██           │▒▒
  6.        │          ░██░░░░░ ██░░░██░░ ██░░     ██░░ ██░██░██░░         │▒▒
  7.        │           ██░░    ██░  ██░░  ██░▐█▌ ██░░░ ██░░████░░         │▒▒
  8.        │           ██░░    ███████░░    ██ ██░░░   ██░░ ███░░         │▒▒
  9.        │             ░░      ░░░░░░░      ░░ ░░      ░░   ░░░         │▒▒
  10.        │                                                              │▒▒
  11.        │         ██████   ██████   ███  ███   █████   ██████          │▒▒
  12.        │         ██░░░░░░ ██░░██░░   █░░█░░░  ██▄▄▄░░ ██░░██░░        │▒▒
  13.        │         ██░░     ██████░░    ██░░    ██░░░   ██████░░        │▒▒
  14.        │         ██████   ██░░ ██░    ██░░    █████   ██░░ ██░        │▒▒
  15.        │           ░░░░░░   ░░   ░░     ░░      ░░░░░   ░░   ░░       │▒▒
  16.        ╘══════════════════════════════════════════════════════════════╛▒▒
  17.            ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  18.  
  19.         The TOWN CRYER   ---------------------------------------  v 1.0
  20.  
  21.                                The TOWN CRYER
  22.                         (C)Copyright 1990, G. Gillis
  23.  
  24.  
  25.  
  26.  
  27.  
  28. Town Cryer - A QBBS/RBBS/RA style doorway.
  29. ----------------------------------------------------------------------------
  30.  
  31.    This door provides a place to post messages, bulletins, notes,
  32.    and announcements - and is a semi-dedicated message base for clubs,
  33.    groups, associations, organizations, news areas, or any other purpose
  34.    limited only by the SYSOP or SIGOP's imagination.
  35.  
  36.    Why?  Although most BBS's have message areas and conferences, this
  37.    door was written to be slightly different.  Nothing like a 'special'
  38.    area for a group of users....   Additionally, this door requires
  39.    a 'poster' to enter an EXPIRATION DATE for the message or announcement
  40.    posted.  The 'maintenance' program for this door will run every night
  41.    and scan the messages for that expiration date, automatically eliminating
  42.    those messages and announcements that have 'expired'.  This method is
  43.    unlike most BBS methods which 'bump' messages only when the number
  44.    of messages exceeds a certain size.
  45.  
  46.    This door is completely configurable - from the catagories down to the
  47.    instructions.....
  48.  
  49.  
  50.    Files Necessary for Operation:
  51.  
  52.               TOWNCRYR.EXE    - the main executable file
  53.                   TOWN.INS    - Town Cryer Instructions
  54.                   TOWN.DAT    - Town Cryer Catagories
  55.  
  56.                   CAT1.DAT \
  57.                   CAT2.DAT  --  ASCII data files created by TOWN CRYER
  58.                   CAT3.DAT /
  59.  
  60.                   TOWN.DOC   -  What you're reading now.
  61.  
  62.               DORINFO1.DEF   -  information file required by TOWNCRYR.EXE
  63.  
  64.             --------------------------
  65.  
  66.                 MTOWN.EXE    -  nightly maintenance program.
  67.  
  68.  
  69.  
  70. THE FILES
  71. ----------------------------------------------------------------------------
  72.  
  73.    TOWNCRYR.EXE:   This doorway was written with Turbo Pascal 5.5.  As such,
  74.               this door requires no other external support files - leaving
  75.               it's size and speed desirable for those with limited Hard
  76.               Drive space.  This door does require the presence of the
  77.               RBBS/QBBS 'DORINFO1.DEF' file - if your BBS doesn't directly
  78.               create such a file, there are many 'door conversion' utilities
  79.               available.  This door operates locally, as well as through
  80.               COM ports 1 through 4.  Multi-node systems?  I don't know...
  81.               It's not been tested on such a system, nor have I insured
  82.               that this will work on such a system.  This door operates
  83.               compatibly with BNU and X00 FOSSIL drivers - and it's
  84.               recommended that you always use a FOSSIL driver.
  85.  
  86.               All files should be placed in the same directory - including
  87.               the DORINFO1.DEF file.  The TOWN CRYER responds to both
  88.               ANSI and ASCII users, however, it does require you not use
  89.               40 column screens (unreadable).
  90.  
  91.    TOWN.INS:  This is an optional instructions file written in ASCII.
  92.               If a user requests to read these instructions, the program
  93.               will check to see if this file is present.  If so, it will
  94.               be presented, if not, a message will inform the user that
  95.               instructions aren't presently available.  Any word processor
  96.               to include EDLIN, will work in drafting up this file.  It
  97.               must be named: TOWN.INS or it won't be recognized.
  98.  
  99.    TOWN.DAT:  Perhaps the MOST important file next to the main executable
  100.               one...  this file contains the NAMES of the three catagories
  101.               available through the TOWN CRYER.  YOU DECIDE the
  102.               catagories - I've only included 'sample' catagories.
  103.               These can easily be changed via a text editor. The file must
  104.               be named TOWN.DAT though, and must contain four lines of
  105.               information. The first three lines are the catagory names.
  106.               The last line (fourth line) contains a number which represents
  107.               the maximum number of posts that you will allow your users per
  108.               call to this door.  This is just a gentle reminder to your
  109.               users not to get too carried away....  this can be bypassed
  110.               by the user by exiting and re-entering the door, starting
  111.               the count all over again.  But again, this is simply to be
  112.               a gentle nudge not to go overboard.....
  113.  
  114.               Example:
  115.               A typical TOWN.DAT file might look like:
  116.  
  117.  
  118.                       Fishing and Boating Club
  119.                       Astronomical Society of the Northern Cities
  120.                       The Bridge Builders Association
  121.                       10
  122.  
  123.               Note, the first three lines are catagories, the last line
  124.               is a number.  You may edit and alter as often as you like -
  125.               making this system completely open to whatever you wish
  126.               it to be.
  127.  
  128.  
  129.    TOWN.DOC:  This file.
  130.  
  131.    CAT1.DAT --- CAT2.DAT --- CAT3.DAT:
  132.               These are the three files created by TOWNCRYR.EXE for each
  133.               of the catagories available.  Each are the same structure -
  134.               and are ASCII files.  Because these files are read
  135.               sequentially - I wasn't concerned with random access times.
  136.               Additionally, as they are ASCII, the SYSOP has the ability
  137.               to view, delete, modify, correct, edit these files without
  138.               the need for a special viewer/editor (as would be required
  139.               by any other type of file).  Any text editor will do - to
  140.               include EDLIN (although that might be quite bulky).
  141.  
  142.    MTOWN.EXE: This is the nightly utility file - it automatically browses
  143.               through the CAT1, CAT2, CAT3 data files and eliminates those
  144.               posts that have 'expired'.  The SYSOP should have this run
  145.               every night when performing automatic system functions.
  146.  
  147.  
  148.  
  149. Disclaimer
  150. ----------------------------------------------------------------------------
  151.  
  152.    Real simple. The author (me) shall not be held responsible
  153.    for any damage, difficulties, legalities, dis-satisfactions,
  154.    or ANYTHING bad in connection with this software and package.
  155.    No matter what!
  156.       --------
  157.  
  158.  
  159. Registration and Distribution
  160. ----------------------------------------------------------------------------
  161.  
  162.    You are free to use and examine this door for up to 30 days.  At the
  163.    end of that time, you are required to either register this door with
  164.    the author or discontinue using this software.  This software is
  165.    copyrighted (Form TX).  When distributing this software, you will not
  166.    modify or alter the contents of this archived file.
  167.  
  168.  
  169. REGISTRATION?        Why Should I Register this?             PLEASE READ!
  170. ----------------------------------------------------------------------------
  171.  
  172.    Why register?
  173.  
  174.    It's inevitable.... many boards and sysops will run doors without
  175.    registering them - ever.   Worse: some (as I've seen) will even run a
  176.    door and strip the copyright and authors name from that door - denying
  177.    the author credit for his or her work.  This is an infringement of
  178.    copyright laws.
  179.  
  180.    But....    This is going to continue to happen.....  unfortunately.
  181.  
  182.    By registering this software (and any software) - you are
  183.    encouraging the authors (including myself) to continue writing solid,
  184.    decent doorware.    If you like this, and you use this... register it.
  185.    You will be supporting the SHAREWARE principles as well as encouraging
  186.    software authors to continue writing utilities and doors for your
  187.    system.
  188.  
  189.    Additionally, although this system will run without being registered,
  190.    those that do register will receive a 5 1/4" disk through the mail with
  191.    a REGISTERED copy of the Town Cryer.
  192.  
  193.    Support software authors....
  194.  
  195.  
  196. CREDITS
  197. ----------------------------------------------------------------------------
  198.  
  199.    Thanks to Mach One of the Surf Board BBS (906-226-6253);
  200.    Turbo Pascal 5.5, a Borland product;  and JPDOOR55 - by John Parlin.
  201.  
  202.  
  203. Comments
  204. ----------------------------------------------------------------------------
  205.  
  206.    Please send comments, ideas, criticisms, and reports of bugs to me at
  207.    the address listed below......
  208.  
  209.  
  210. REGISTRATION DONATION
  211. ----------------------------------------------------------------------------
  212.  
  213.    Send Donation Check or Money Order of the amount of $5.00 U.S. dollars to:
  214.  
  215.                                        Gregg Gillis
  216.  
  217.              Address before May '91:   120 Northland
  218.                                        Marquette, MI  49855
  219.  
  220.              Address after May '91:    4125 Stratford
  221.                                        Boardman, OH 44512
  222.  
  223.  
  224. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  225.  
  226. The Town Cryer v1.0 Registration Form:
  227.  
  228.  
  229.       Your Name: __________________________________
  230.  
  231.         Address: __________________________________
  232.  
  233.            City: __________________________________
  234.  
  235.           State: ___        Zip: _______
  236.  
  237.  
  238.      SYSOP Name or BBS Name you would like this registered to:
  239.  
  240.                                __________________________________
  241.  
  242.                       BBS Type:         _________________________
  243.  
  244.               BBS PHONE NUMBER:         _________________________
  245.  
  246.           FOSSIL DRIVER:  Y  N   Type:  _________________________
  247.  
  248.                        MAX BPS:         _________________________
  249.  
  250.                  TYPE COMPUTER:         _________________________
  251.  
  252. -----------------------------------------------------------------------------
  253. Thank You!!!
  254.  
  255.